亲测有效！Codex桌面版免费接入DeepSeek V4
亲测有效！Codex桌面版免费接入DeepSeek V4
来源：htmlDecode("科技爱好者站")
原文链接：https://mp.weixin.qq.com/s/w1Ta5WBx9_-H1qcUv2lwTQ
** 导读： ** OpenAI Codex 是一款强大的 AI 编程助手，但官方模型价格不菲。DeepSeek V4 作为国产大模型的新星，不仅性能强悍，价格更是只有 GPT 系列的十分之一。本文将手把手教你如何在 Codex 桌面版中接入 DeepSeek 模型。
一、为什么选择 DeepSeek？
DeepSeek V4 发布后，在多项基准测试中表现亮眼：
• ** 性价比极高 ** ：DeepSeek V4 Flash 输入仅 $0.27/百万 tokens，缓存命中低至 $0.07/百万
• ** 性能强悍 ** ：编程任务表现出色，推理能力接近 Claude Opus 4.6
• ** 双协议支持 ** ：同时兼容 OpenAI 和 Anthropic 两种 API 格式
** 价格对比： ** 模型名称 输入单价 （每百万 token） 输出单价 （每百万 token） GPT-5.4 $10 $30 Claude Opus 4.6 $15 $75 DeepSeek V4 Flash $0.27 $1.10
💡 选择 DeepSeek V4 Flash 可以节省 ** 90% 以上 ** 的成本！
二、核心问题：协议不兼容
** Codex 新版本（v0.81.0 及以上）使用的是 OpenAI Responses API ** ，而 DeepSeek 官方 API 使用的是 Chat Completions API。这两个协议不兼容，直接配置会导致工具调用失败。
** 具体表现： **
• 工具调用报错：insufficient tool messages following tool_calls message
• 推理模型报错：Missing reasoning_content field
** 解决方案： ** 需要一个「中间代理层」，将 Codex 发出的 Responses API 请求转换为 DeepSeek 能理解的 Chat Completions API 请求。
目前主要有三种解决方案：
1. ** Moon Bridge ** - 官方推荐的 Go 语言代理。 社区开发者维护。功能更全。
2. CCX： 配置简单
3. Codex-bridge： 轻量方案 **
**
三、方案一：Moon Bridge（官方推荐）
Moon Bridge 是 DeepSeek 官方文档中推荐的开源代理方案，功能完整，支持 V4 的推理模式扩展。
3.1 环境准备
• Node.js 18+（下载地址）
• Go 1.25+（下载地址）
• Codex CLI（安装命令：npm install -g @openai/codex）
3.2 获取 DeepSeek API Key
第一步：访问 DeepSeek 开放平台
第二步：注册或登录账号
第三步：进入 API Keys 管理页面
第四步：点击「创建 API Key」，复制并妥善保存
3.3 克隆项目并配置
打开命令行终端，执行以下命令克隆项目：
git clone https://github.com/ZhiYi-R/moon-bridge.git
cd moon-bridge
在项目目录下创建 ** config.yml ** 配置文件：
mode: "Transform"
server:
addr: "127.0.0.1:38440"
provider:
providers:
deepseek:
base_url: "https://api.deepseek.com/anthropic"
api_key: " sk-你的DeepSeek密钥 "
models:
deepseek-v4-pro:
context_window: 1000000
max_output_tokens: 384000
extensions:
deepseek_v4:
enabled: true
default_reasoning_level: "high"
routes:
moonbridge:
to: "deepseek/deepseek-v4-pro"
default_model: "moonbridge"
3.4 启动代理服务
在终端中运行：
go run ./cmd/moonbridge --config config.yml
代理默认监听 ** 127.0.0.1:38440 ** ，保持终端窗口打开。
3.5 生成 Codex 配置文件
打开另一个终端，在 moon-bridge 目录下执行：
CODEX_HOME_DIR="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME_DIR"
MODEL="$(go run ./cmd/moonbridge --config config.yml --print-codex-model)"
go run ./cmd/moonbridge \
--config config.yml \
--print-codex-config "$MODEL" \
--codex-base-url "http://127.0.0.1:38440/v1" \
--codex-home "$CODEX_HOME_DIR" \
> "$CODEX_HOME_DIR/config.toml"
这会在 ** ~/.codex/ ** 目录下生成 config.toml 和 models_catalog.json 文件。
3.6 启动 Codex
cd /path/to/your-project
CODEX_HOME="$HOME/.codex" codex --cd "$PWD"
现在 Codex 会通过 Moon Bridge 将请求转发到 DeepSeek V4。
四、方案二： 用CCX（最简单）
4.1 下载地址
Windows： ccx: https://pan.quark.cn/s/2d43ca4e5aef Switch: https://pan.quark.cn/s/57b769c2ff0b
Mac： ccx: https://pan.quark.cn/s/b8a553da956c Switch: https://pan.quark.cn/s/d9cd3eb9ce31
Linux： ccx: https://pan.quark.cn/s/dc582154254e Switch: https://pan.quark.cn/s/a6b587a76c8c
4.2 解压并配置API Key 解压后找到.env文件填上API Key即可。API地址填 https://api.deepseek.com
4.3 启动代理程序
因为Codex只支持OpenAI自家的模型。想用DeepSeek， 加一个翻译官——本地代理。Codex发的是Responses请求，代理翻译成Chat补全请求发给DeepSeek，再把结果翻译回来。
五、方案三：codex-bridge（轻量方案）
如果你更喜欢 Node.js 生态，codex-bridge 是个更轻量的选择。
5.1 克隆项目
git clone https://github.com/wujfeng712-ui/codex-bridge.git ~/.codex/codex-bridge
cd ~/.codex/codex-bridge
5.2 创建环境变量文件
在项目目录下创建 ** .env ** 文件：
# DeepSeek API 密钥
DEEPSEEK_API_KEY=sk-你的DeepSeek密钥
# 可用模型列表
DEEPSEEK_MODELS=deepseek-v4-pro,deepseek-v4-flash,deepseek-reasoner
# 默认供应商
DEFAULT_PROVIDER=deepseek
# 日志级别
LOG_LEVEL=info
5.3 配置 Codex
编辑 ** ~/.codex/config.toml ** 文件：
[model_providers.deepseek_proxy]
name = "DeepSeek Proxy"
base_url = "http://127.0.0.1:4000/v1"
env_key = "DEEPSEEK_API_KEY"
wire_api = "responses"
[profiles.deepseek_pro]
model = "deepseek-v4-pro"
model_provider = "deepseek_proxy"
[profiles.deepseek_flash]
model = "deepseek-v4-flash"
model_provider = "deepseek_proxy"
5.4 启动代理
cd ~/.codex/codex-bridge
node index.js
代理默认监听 ** 127.0.0.1:4000 ** 。
5.5 启动 Codex
codex --profile deepseek_flash
六、常见问题排查
** 1. 连接被拒绝（connection refused） **
→ 检查代理服务是否正在运行，确认端口配置一致
** 2. Codex 无法看到 DeepSeek 模型 **
→ 重新运行配置生成步骤，确保 models_catalog.json 存在于 CODEX_HOME 目录
** 3. 认证错误（401 Unauthorized） **
→ 检查 DeepSeek API Key 是否正确，确认账户余额充足
** 4. 工具调用失败 **
→ 确认使用的是代理方案而非直连。DeepSeek 不支持 Responses API，必须通过代理转换
** 5. 图片输入失败 **
→ Moon Bridge 的图片功能需要单独配置视觉模型提供商，或在配置中禁用 visual
七、最佳实践建议
经过实际使用，推荐以下分工策略：
** 复杂架构设计、大规模重构 ** → Claude Opus 4.6 / GPT-5.4
问题定义不清晰时需要更强的推理能力
** 日常代码编写、格式化、测试 ** → DeepSeek V4 Flash
质量足够，成本极低
** 意图识别、日志分类 ** → DeepSeek V4 Flash + 缓存
缓存命中率高，成本最低
八、总结
Codex 桌面版接入 DeepSeek 模型的核心在于解决协议兼容问题。
** 选择建议： **
• ** 新手入门 ** ：推荐 用CCX，配置简单
• ** 追求稳定 ** ：推荐 Moon Bridge，官方支持
📌 ** 参考资料 **
• DeepSeek 官方文档：api-docs.deepseek.com
• Moon Bridge 项目：github.com/ZhiYi-R/moon-bridge
• codex-bridge 项目：github.com/wujfeng712-ui/codex-bridge
• CliGate 项目：github.com/codeking-ai/cligate
• OpenAI Codex CLI：github.com/openai/codex